home *** CD-ROM | disk | FTP | other *** search
/ Mac-Source 1994 July / Mac-Source_July_1994.iso / Other Langs / Mops / README.1ST (source release)
Text File  |  1993-02-28  |  6KB  |  162 lines
  1. This is Mops 2.3, of Feb 1992.
  2.  
  3. This is the source release, which also contains the nucleus as an
  4. application, so you can compile up the whole system by following
  5. the instructions below, which (I hope) aren't hard.  You will also
  6. need the manual, which should be available as a file called something
  7. like Mops23m.sea at the same location from which you obtained this.
  8. It's a separate file because of size. 
  9.  
  10. There is also a binary-only release, Mops23b.sea, which you can get if
  11. you don't want to have to do a recompile.  But the recompile will
  12. probably be less bother.  It really isn't hard.
  13.  
  14.  
  15.             ============================
  16.  
  17. There are two folders, "Mops ƒ" and "Mops Source".
  18.  
  19. "Mops ƒ" contains:
  20.  
  21. *** The Mops application itself
  22.  
  23. *** The source files which get loaded above the nucleus, but before
  24. HFS file handling is available - Base, Args, Class, Struct, String, Files 
  25. and Modules.  These must be in the same folder as Mops.
  26.  
  27.  
  28. "Mops source" contains all the other Mops source files (of course!!)
  29.  
  30. The folder "More classes" contains various ex-Neon classes that I 
  31. have converted, as well as a number of other classes I have written over 
  32. the last few years.  Some of these have not been updated to the latest Mops 
  33. version, but only minor changes would be needed. There is some code there 
  34. which can read and write formatted Microsoft Word documents. I need this
  35. capability in my work. By the way, hacking out the MW document format for
  36. versions 1-4 was no joke!!  (Yes, the code will read "fast saved" 
  37. documents.)  But I haven't added Word 5 support, and probably won't ever,
  38. since I've now changed over to Nisus (yes, this is a Microsoft-free zone).
  39.  
  40.  
  41. If you don't alter the folder configuration as supplied, things should 
  42. work. If you want to put all the Mops stuff into a folder, or change the 
  43. folder configuration, you will need to edit the file "Mops.paths" in the 
  44. "Mops ƒ" folder - this defines the HFS paths that Mops will use to look for 
  45. files.
  46.  
  47.  
  48. There is also one file, "Mops 2.3 release notes".  This is mainly aimed
  49. at current Mops users, and describes the differences in this release, as
  50. well as likely future developments.
  51.  
  52.  
  53.                 ===============================
  54.                 
  55. Now, here are the instructions for compiling everything, to get you up
  56. and running.
  57.  
  58. First start up the nucleus application "Mops" and type
  59.  
  60.         <" base
  61.  
  62. Or, for faster compilation with echoing off, type
  63.  
  64.         -<" base
  65.  
  66. If no errors come up, you'll get the Mops prompt  0->  after a minute or
  67. so. Save the partial dictionary with
  68.  
  69.         save <name>
  70.  
  71. where <name> is whatever you want. This dictionary image will end up in the
  72. "Mops ƒ" folder.  If something goes wrong in the next stages, you can
  73. get back to this point by double-clicking on this dictionary.
  74.  
  75. Now, to compile the rest of the dictionary, type
  76.  
  77.         // sys.ld
  78.  
  79. and everything else should be compiled.  It only takes a couple of minutes
  80. on a Mac Plus, less on faster Macs.  Save it again when it's finished, with
  81.  
  82.         save Mops.dic
  83.  
  84. You can then type
  85.  
  86.         run
  87.  
  88. to bring everything to life.
  89.  
  90. Finally, compile the floating point with
  91.  
  92.         // floating point
  93.  
  94. and when it's compiled, save with
  95.  
  96.         save MopsFP.dic
  97.  
  98. Then quit with BYE, or by choosing Quit.  You should be able to fire
  99. up either the standard or floating point system by double-clicking
  100. on the dictionary image Mops.dic or MopsFP.dic.
  101.  
  102.  
  103.                 ================================
  104.  
  105. If you already have the binary release, and don't want to do the recompile,
  106. you will need to combine the contents of the "Mops ƒ" folders from the
  107. two releases.  Just copy all the files from one into the other.  You
  108. can replace duplicate filenames -- any files with the same names should
  109. be identical anyway.
  110.  
  111.                 ================================
  112.                 
  113. Finally, please note that I am releasing all original Mops material into 
  114. the public domain.  If you want to use it commercially,
  115. that's fine, but I'd really appreciate it if you could let me know. In
  116. return I could let you know of any late-breaking bugs/fixes which may be
  117. very helpful to you.
  118.  
  119.  
  120. I assemble the nucleus source with Dave McWherter's shareware McAssembly. I
  121. gather it is reasonably compatible with other Mac assemblers. (Unfortunately,
  122. it doesn't work under System 7, so I might have to change to MPW in the
  123. future.)
  124.  
  125. After assembly, ResEdit should be used to copy all the resources in the 
  126. resource file FWind over to Mops. Also, if you're using McAssembly, use 
  127. ResEdit to set the bundle bit, which McAssembly helpfully neglects to do.
  128.  
  129.  
  130. I'd also like to know about any other Mops development that anyone feels 
  131. free to let me know about.  Even better, if you develop some whiz-bang new 
  132. class or whatever, you could send me a copy on disk and I could make it 
  133. part of the standard Mops release.  As a one-man part-time effort, Mops 
  134. can't hope to compete with the slick commercial products - but with a bit
  135. of cooperation from those using it, Mops could become a very useful 
  136. development system, and the price is certainly right.  (So is the 
  137. performance, I think you'll find.)
  138.  
  139. If you have any queries, comments or (gasp!) bug reports, please send me
  140. an email message at one of the following:
  141.  
  142. internet:     mikeh@kralizec.zeta.org.au
  143. CompuServe:   100033,3164
  144.  
  145. snail-mail:
  146.         Michael Hore
  147.         54 Frederick St,
  148.         Sydenham  NSW 2044,
  149.         AUSTRALIA.
  150.  
  151.  
  152. I also read the newsgroup comp.lang.forth, so you can post there and I'll
  153. see it, especially if you put "Mops" somewhere in the subject line.  There
  154. is also a Mops topic on GEnie (Forth RoundTable, category 7, topic 40).
  155. I don't currently have access to GEnie, but messages there are cross-posted
  156. to comp.lang.forth, so I'll see them there.
  157.  
  158. I hope you enjoy Mops.
  159.  
  160.  
  161. --  Mike Hore.
  162.